Skip to content

Support non-Docker local installations - #108

Open
thomwolf wants to merge 1 commit into
mainfrom
agent/support-local-installations
Open

Support non-Docker local installations#108
thomwolf wants to merge 1 commit into
mainfrom
agent/support-local-installations

Conversation

@thomwolf

@thomwolf thomwolf commented Aug 21, 2026

Copy link
Copy Markdown
Member

Summary

  • add a small installer for the npm-distributed agent CLIs used by non-Docker deployments
  • resolve Claude and OpenCode lifecycle helpers from the repository checkout instead of assuming /app/scripts
  • bind direct Node/systemd deployments to 127.0.0.1 by default while keeping the Docker image explicitly reachable on 0.0.0.0
  • declare the native dependency install scripts required by the server and explicitly deny the optional fsevents script
  • document the persistent local deployment, PATH, bind-address, and authentication requirements
  • add focused regression coverage for checkout-relative lifecycle helpers and the local/container bind contract

Why

The Docker image installs the agent CLIs and places application scripts under /app, but those build steps and paths do not exist when Agent Manager is launched directly with Node or systemd. A direct deployment also has no Hugging Face edge authentication, so listening on every host interface by default would expose an unauthenticated shell.

This keeps the Docker behavior unchanged while giving local deployments an explicit provisioning path, portable helper locations, and a loopback-safe network default. Operators can deliberately set BIND_HOST when placing an authenticated reverse proxy in front.

Validation

  • rebased onto current main (4faae2f)
  • npm ci --strict-allow-scripts
  • npm test -- local-install opencode-resume
  • sh -n scripts/install-local-clis.sh
  • git diff --check main...HEAD

@thomwolf
thomwolf marked this pull request as ready for review August 25, 2026 12:54
@thomwolf
thomwolf force-pushed the agent/support-local-installations branch from 1dab135 to f0a4fae Compare August 25, 2026 13:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant